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1. Preface 

This documeit contains information about features and programs of XENIX 3.0 
Release 1.1 for the IBM PC. Please read through this entire documen 
before installing XESIX for the IBM PC. 



2. IMPORTANT NOTE ABOUT INSTALLATION 

Please refer to the Installation Guide in the binder marked XENIX Operating System 
Installation Guide/Operations Guide/User's Guide to install the XEVIX Operating 
System. If you have purchased all three Systems, (XENIX Operating System, 
Development System and Text Processing System) you can use the XENIX 
Installation Guide to install them all at once, if you wish to install the Development 
System and/or the Text Processing System at a later time, refer to the /f«/eaj« ^M«5 at 
the beginning of the appropriate guide (XENIX Programmer's Guide or XENIX Text 
Processing Guide). Read the installation notes in their entirety and make sure you 
completely understand the tnstallation]nocessbefore installing the jvoduct. 

The three ^stems are delivered on these floppies: 

XENIX Operating System -BootaWeFloppy.RooiFloppy, 

Roppiesl~9 
XENIX Develo|xnent System (Optional) -Floppies 1~S 
XENIX Text Processing System (Optional) - Floppies 1 -4 

NOTE: In order to conserve disk space installation of Floppy #8 of the XENIX 
Operating System, which contains fifes used by the eaiC) and iiocp(Q for 
communication between XENIX and/or UNIX™ systems, is optional. The XENIX 
Installation Guide contains more infoimation on this optional step. However, you 
MUSTgooatoinstallinoppy#9tocompletetheSysteminstallatioa. 



3. Compatible Software and Hardware 

This section covers some of the hardware and software which has been found to be 
compatibfe withXENIXfortheiBM PC. 

3.1 Software Applkations Availabk 

The foOowing software application paduges are available from The Santa Cruz 
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Opentionforuse with XENIX on the IBM PC. 

Lytix"* Wcrd Processing System 

Infonnixf Relational Database Mamgemeat System 

Muhiplan* Electronic Woiisheet 

LEVELUCOBOL"^ GSAceitifiedhigb level 1974 ANSI standard 

CaUTIieSantaQuzOpention or your local dealer formoreinformatioiL 

3.2 Computers 

In addition to the IBM PC XT. XENIX for the IBM PC has been successfully installed 
on the following machines. This list is subjecttocfaange without notice. 

Manufacturer Model 

AT&T 6300 

Columbia 1600-4 

COMPAQ PLUS 

Direct with I Omegabyte hard disk 

Eagle Turbo 

LeadingEdge with 1 Omegabyte hard disk 

Olivetti (Available in Europe) 

Speny with 1 Omegabyte hard disk 

Tava with lOmegabytehard disk 

3.3 Hard Disks 

In addition to the hard disks listed in the IBM PC XT documentation, the following 
hard disk is sui^;>oftedforuse with thelBM PC. 

Manufacturer Model 

Univation lOandZOmegabyteHardDisks 

3.4 Multi-Fimctioii Memory Cards 

The followingmuki—functionmemory cards are suppoited. 

Manufacturer Model 

AST SixPackPlua 

Quadram QuadBoaid 

Sigma Maximizer 

Microsoft RamCsd 

Tedour Captain, IstMate 

NOTE: Generally, any muhi- function card which is plug compatible may woik, 
although only for additional memory (i.e. real— time clocks and other extras may not 
fiinctionasexpected). SerialandparaUelpcitsmay work, butmust be jumpered. 
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3.4. 1 Signu Prodncts Memory Card 
TheclockiotenupcjumperlAQS/lRQ2 should be set to 1RQ2. 

3.4.2 AST Sfat Pack PIm Memory Card 

The Poit Enable Jumper Block must have the switch set to pin 2 (act pin 1 ). The IRQ 
EnaUe Jumper Block must have the twitch set to 1RQ3 (iKtlRQ4). 

3.5 Modems 

The Hayes Smaitmodem 1200 u supported for autodialing using ancp(Q. Any 
standard RS-232 modem will work with XENIX for the IBM PC using cd(Q. 
However, you will not be able to use autodialing. Future releases will support 
autodialing for en (C) and modems other than the Hayes. 

4. Features of the 1.1 Release 

This section relates important features of XENIX for the IBM PC. 

4.1 System Performance 

The 1 . 1 Release contains several performance enhancements including optimized 
serial, console and disk i/0,andafaster hard disk boot. 

4.2 PC-DOS or MSi^-DOS support 

XENlXforthelBMPCsupportsthccoexistenceofDOS{PC~DOSorMS-DOS)and 
XENIX on the same hard disk. Consuk Appendix C of the XENIX Operations Guide 
and the manual entries for fdJskCQ and das(Q. The fdisk(Q utility creates and 
changes multiple disk partitions, allowing separate XENIX and DOS partitions. 
fdisk(Q has similar functionality to the DOS utility of the same name. The utilities 
mentioned indos<Qallow access to DOS files on thehard disk and floppy did^ettes. 

To read DOS version 1 . 1 eight sector floppies you must use the proper device. For 
single sided floppiesuse: 

fd048ss8 

For double sided floppiesuse: 

fd048ds8 

The file letddefiutitlmsdos b an easily configurable fiJe used to alias default device 
names of do»<C) options. For a more complete description of using letddefaultimsdos 
see the manual page dos(Q inthe XENIX /7^ere/re . 
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Reserve a sufiSciemly large partition far XENIX via fdiskCQ should yov decide to 
insull XENIX and DOS on the aame hard disk. Each cylinder on an IBM PC XT is 
34.816 bytes of storage. The number of cylinders allocated for a XENIX partitioa is 
based upon the size of your system. 

Fcdiowing is a list of the available configurations and the recoounended number of 
cylinders for each. fdJskCQ reports that 162 cylinden is the minimum size to reserve 
for XENIX. fdidt(0 doesn't allow for any fire blocks. However, these figures have 
been cakulated to provide 1700 IK bkxks of firee space available to the XENIX file 
system: 

PACKAGE CYLINDERS 

XENIX OperattngSystem 172 

XENIXOS + Development System 221 

XENIX OS -HTextProcessing System 211 

XENIX OS. Dev. Sys. + TextProc. Sys. 260 

NOTE: The size ofacylinderdqpendsonthetypeofharddiskyouhave. Forexample, 
theMiniscribeHalfHigh (or equivalent)harddiskcontains 17.408 bytesofstorageper 
cylinder. Checkyour hard disk manual for the size of the cylinders on your hard disk, 
if you have one of these types of disks, use the following table to allocate cylinders for 
the XENIX System: 

PACKAGE CYLINDERS 

XENIX Operating System 344 

XENIX OS + Development System 442 

XENIX OS + Text Processing System 422 

XENIX OS, Dev. Sys. + TextProc. Sys. 520 

If you wish to use one hard disk for XENIX and one hard disdc for DOS . you must have 
XENIX on the boot drive. DOS can be booted from a floppy, or you can maintain a 
small DOS boot file on the boot drive which accesses files on the other hard disk. You 
can mount XENIX file system partitions on a second disk. Refer to the XENIX 
Reference manual pages for rdisk(Q,moQiit(C), and mkfs(Q and the XENIX 
Operations Guide chapter on "Using Periphenl Devices" section on *'Adding a 
SecondHardDisk" formoreinfomiatioa. 

4.3 Multiscreen^ and Color Support 

The IBM PC console under XENIX can act asa console and up to 9 separate terminals, 
each of which can support differeit activities (see the manual page for coosdc(M) in 
the XENIX Rtference and the chapter ''Using Peripheral Devices" in the XENIX 
Operations Guide). Please note that messages firom the kernel appear on the console 
screexL WhenthishappensthecoosoIescreendi^Tlaysinsteadofthccurrentscreen. 

If you have a cokir monitar ±c XENIX utility ictcQlor(Q allows you to select the 
foreground and background screen cokirs firom a palette of 16 colors (see die manual 
page {otttetaiar(Q'm±eXEmXReference). 
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4.4 Software Reboot 

The 1 . 1 Release allows software rebooting. You need not power off to reboot. The 
foUowingmessage isdisplayedaftera system shutdown. 

*♦ Safe to Power Off •• 

-or- 
♦* Hit Any Key to Reboot** 

Note: If the floppy drive door is dosed, the computer win attempt to boot offa floppy. 
The floppy drive door must be open when you use the software reboot to boot off the 
hard disk. 

4.5 Memory Limitatioiis 

Some utilities may not run on syftems with less than 384 kilobytes of main memory. 
vsb(C), the Microsoft visual shell and vi(Q, the Berkeley full- screen editor, are 
examples of these . When you invoke a utility that needs more memory than available, 
the message * 'Killed* * appears on your screen. 

vKO. and vsb(Q are suppoited for machines with 384 kiiobytes of mainnwmory or 
greater. 

4.6 SmaU Version XENIX 

We have inchided the option of insulling a smaller version of the XENIX kernel and 
fsck(Q for configurations with less than 384 kilobytesofmainmonory. They will run 
on systems with at least 256ki]obytesofmainmemory. Note that the small XE.NIX for 
the IBM PC kernel supports one console screen, fewer internal buffers, and fewer 
maximum simultaneous processes than the large kernel. The smaller versions of the 
utilities functionessentially the same as the larger versions. 

Please consult the XENIX Installation Guide for the ap propr i ate tnstallationprocedure. 
If you decide at some future time to upgrade to more main memory , refer to the XE24IX 
Installation Guide to install the larger, full featured versions at that time. You can also 
follow the same procedure if you decide to reduce the amount of mcmocy available and 
wish to install small versionXENIX. 

4.7 Shared Data and Semaphores 

XENIX supports shared dau and semaphores. Those who purchased the XENIX 
Development System can consult the chapter on "Using System Resources" in the 
XENlXProgrammer'sReference for more infonnation. 

4.8 2.3 Binaries 

The system now executes Mkiosoft version 2.3 8086 binaries (for example. Altos 
586or Intel 86330binaries). 
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4.9 Floppy Formatting Utility 

XENIX for the IBM PC provides « floppy forautting utility calkd formaKQ. Tlie 
floppy fomui b compatible with DOS 2.0. This utility can be run while XENIX is 
operatingmulti-userandpaformingotha functions. Consult the farmat(Q manual 
page in the XENIX /f<fer«/tc«farusage. 

4.10 8087 Support 

Your IBM PC may include the 8087 math co-processor, which is suppoited by 
XENIX for the IBM PC. Please note that switch # 2 on the main switch box on the 
system board must be ofif in order to enable 8087 intemipts. Some 8087 exceptions 
have been masked. Refer to the manual page for 8087(M). Note that the 8087(M) 
manual page iDcocrectly states that underflow exceptions wiO cause an interrupt 
Underflowhasbeenmaiked. and will not create an exceptioo. A new manual page is 
included with these notes. PteaseinseititijxtoyourXENIX/7</«rtf«re. 

4.11 Contents Listings 

These notes include a list of the files contained on each floppy in the XENIX Operating 
System of Release 1.1. 

It sometimes becomes necessaiy to reinstall a file from an Operatmg System 
distribution floppy because of inadvertently removing a file due to a hardware 
malfunction or operator error. Ifyou need to reinstall a fiJe from an Operating System 
distribution floppy, check Floppy #9 first. Any file hsted on Floppy #9 takes 
precedence over the same file on any other floppy . 

The installation of Floppy #8 (containing oncp related files) b optional. The 
installation of Floppy #9 b NOT optional. Refer to the XENIX InsuUlation Guide for 
the proper instaBatioo procedure. 



5. Hardware Notes 

This sectioncootains notes relating tohardware issues. 

In general, your hardware configuration must have the original settings and boards 
before youbootXENIXforthe IBM PC. ifyou have added any boards, make sure that 
all switches are set as recommended in the manufacttirer's hardware manual for that 
board. TheseguideUnesmustbefoUowed.toensurepropersystemperformance. 

5.1 Paraiiei and Serial Printer Setup 

One and only one parallel printer can be used on the XENIX System (because diere b 
one interrupt vector available). Refer to the XENIX Operations Guide, cfaapla on 
"Using Perq>heral Devices" for iofonnatkm on connecting and using serial and 
parallel printers. 
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5.2 Floppy Light After Shutdown 

The flopf>y disk access li^t may suiy on after« system shutdown. Thisisnothaimful 
and floppy disks cube fonoved firom the disk drive without risk. 

5.3 Serial Lines 

XENIX for the IBM PC supports modem control on up to two serial ports. The 
following device namesreferto the serial poits with and without modemcontroL 

/dev/ttyll uses main serialadaptor without modem control. 

/deWttyl2 usesaltemateserialadapccrwithoutmodemcontiol. 

/dev/ttyl3 usesmainaerialadaptorwithmodemcontrol. 

/dev/ttyl4 usesabemateserialadaptorwithmodemcontroL 



6. uuqKQ- Common Problems 

This section refers to problems you may have with oacpCQ and cii(C). The micp 
programs and utilities are on FkiTpy #8 of the Release 1 . 1 set, and its installation is 
optional. Also refer to the chapter ''Building a Micoet Network" in the XENIX 
Operations Guide and the chapter on "Building a VVCP System" in the XENIX 
Ustr'sGuide 

6.1 Modem Usage under XENIX 

Refer to the XENIX Operations Guide , CSiapCer on ' 'Using Peripheral Devices' * for 
information on modem settings, modem control, aliasing alphabetic characters and 
dialing withyourcomputer. 



7. Software Notes 

This sectionexplains some software issuesof note. 

7.1 Ipr(C) 

DO NOT USE the Ipr(Q command unless you have a line printer attached to your 
computer. Sending a file to a oon—existent line printer produces an unkillable Ipd 
process. 

If you do scfid a file to a oon— eaitoent prirter, restore the system to nonnal by typing 
the followingcommands: 
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cd Aisr/spool/lpfl 
nn • 

This removes the text, coitrol and lode files wutiog forthe oon— exutent printer. The 
Ipd process is still luxmiog. however. To remove it you must sfantdowa the system, 
thenrtboot 

7.2 vshCQ 

DO NOT USE the nk Prist command unless you have a line primer attached to your 
computer. ThcPrintcommandseadsthedesignatedfiktothelineprinterandstartsaa 
unkillablelpdpfocesss. The previous (]pr(C)) section explains this situatioa 

The Microsoft Visual Shell. valKO, does HOC. at present, suppoit die use of "special 
characters'* when specifying filenames. The use ofthese special characters (*. [ ]. 
and ?)uexplained in the chapter"Basic Concepts" in the XENIX C/5er'jCui<i!«. 

7.3 3.0 liOgin 

Under XENIX 3.0. only die super-user may execute logiii(C) from a shell. Hence 
non— super— users oust log out or use aoodierscreeninorderto log inasanotheruser. 

Furthennore. there has been a change in logiB's functionality. The new XENIX 3.0 
logianests, (i.e.. the current user is not logged out). Whenthe new user (super-user) 
logs out. the previous user b still ninning. See the logfai(Q manual page for more 
information. 

7.4 mktBer(C) 

The mknscr program has been enhanced. The utility has a iMffereot order than 
documented in the XENIX Operations Guide chapter on "Preparing XENIX for 
Users." 

Aiteryou enter the newuser'sloginnamethe following prompt appears: 

Oo you want to use the default group (y/iO? 

If you type * 'y," the user b assigned to the group "group. " If you type * *n," you may 
thenenteroneoftheothergroupa. The group may be a group already in/ecc/^roi^ or 
you can specify a new group which will be created and added to/«rc/;roup . 

Next, the progr am asks for the password, as documeited. The next step is to enter the 
user'sshell. You will see the foQowtng: 

ENTER sheQ type (1. 2. or 3) and press ENTER: 

If you asked for instructions when you started mknscr, you will be toU what the Aells 
are, otherwise thb b all you will see. Type 1 (for tlKQ). 2 (for vsh(C)) or 3 (for 
csWQ). 

Finally, you will be asked to enteracommeflt.asdocumented. 
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7.5 Time Zone Changes 

The time zone in this releue b inittiify let to Pacific Standard/Daylight Time 
(PST/PDT). You will be prompted diiringinstallationforyourtinie zone. 

Each csh user win need to modify their ./oj^i file with the approfviateTZ setting. For 
example the line: 

setenv IZ ESTSEDT 

setsTZtoEastemStaodard/OaylightTime. 

RefertotheXENlX/wra//ar<oiiCiMc^ for more onTZ. 

7.6 printenv 

The XE>ax 2.3 printenir command has been replaced in XENIX 3.0 by the cnv(Q 
command. The printeBv shipped is limpfy a link to the 3.0 command cav<Q. Seethe 
cnv(Qmanual page forthe enhanced emr functionality. 

7.7 Terminal Type 

During XENIX insullation your terminal type will be set depending on whether you 
have a color card or not. This bdone sotfiatyou may take advantage of the cokv feature 
when using application packages (such as the Lyris word processor). Refer to the 
XENIX Operations Guide chapter oa ' ' Using Peripheral Devices' * for instructions on 
changing terminal types. 



8. Documentation Errata 

This sectionrelates errors found in the dociunezsatioit 

8.1 MachineCM) 

Themanualpagemachiiic(M)wasleftoutoftheX£NIX/?<ftfrtf/re.ltistacludedwith 
\hex Release Notes. Please insert it into yourmanual. 

8.2 Mount(Q 

The syntax givenforiiioaat(C)is incorrect. ItshouMbeasfoOows: 

/etc/mourn f[ -r] special-device directory] 

A new moanKQ manual page it included with these Release Notes . Please insert it 
intoyour XENIX /?</rrriice. 
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8.3 Building a Micnet Network 

aiapta9 of the XENIX 0/)«ni/u7)u Ciiiife on page 9- 1 2 diows the example: 

cat Sivl^coVvcxxitUmachine-'namdLQG 
Thisexample shouldread: 

cat /uu/i^ooVaucaeUnmcte/nuchine—nanu/LDQ 

8.4 Adding a Second Hard Disk 

The "Adding a Second Hard Disk" section in the "Using Peripheral Devices" 
dupteroftheXENIXO/w/YxrioiuGiMcitfCDisainsumissii^aooamiandline. Step2of 
the procedure entaib nuking device nodes corresponding to the second drive. The 
coounand lines todo so should be the foUowing: 

# /etc/mkood /dev/hdl b 

# /etc/mknod /dev/hdlds 

# /etc/mknod /dev/hdlbb 

# /etc/mknod /dev/hdl pi 

# /etc/mknod /dev/hdl p2 

# /etc/mknod /dev/hdl p3 

# /etc/mknod /dev/1ullp4 

# /etc/mknod /dev/hdlpanun 
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floppy #5 



/etc/default/restar 
/etc/devnn 
/etc/fixpenn 
/etc/inir 
/etc/mkDod 
/etc/mittab 
/etc/moua 
/ctc/passwd 
/etc/profile 
/etc/rmuser 
/etc/setnut 
/etc/sulogin 
/etc/systemid 
/etc/ltyt 
/etcAimoua 
/etcAitmp 
/lib/cvtdate 
/usr/adm/owtmp 
/usr/adm/sulog 
/usr/bin/acctcom 
/usr/bin/deassign 
linked toAisr/bin/assign 
/usr/bin/atnn 
/usr/bin/bdiff 
/usr/bin/calendar 



/etc/defaub/su 

/etc/dmesg 

/etc/group 

/etc/lpopen 

/etc/mkuser 

/eu:^M>td 

/etc/oetutil 

/etcybtae.penns 

/etc/rc 

/etc/secoodiime 

/etc/shutdown 

/etc/sysadmin 

/etc/teroKap 

/ctc/itytype 

/etcAipdate 

/etc/wall 

Aisr/adnvteessages 

Aisr/adm/pacct 

^sr/a(kD/wtInp 

Aisr/bin/asstgn 

Aisr/bio^at 

/usr/bin/aiq 

/usr/bin/bc 

/usr/bin/bfs 

Aisr/bin/onchk 



floppy #6 



/usr/bin/finger 

/usr/bin/Ipr 

/usr/bin/more 

/usr/bin/pcat 

/uar/bin/randaai 

/usr/bin/rcp 

/usr/binAinits 

/usr/demo/. profile 

/usr/cdemo/. login 

/usr/lih/atrun 

/usr/lih/cronlog 

/usr/lilVdifDprog 

/usr/!iiycx2. 1 3preservc 

/usr/liiyex2.13striiigs 

/usr/litVlpd 

/usr/litymail/aliasha^ 

/usr/litymail/exec.mn 

/usr/iih/mail/faliaaes 



Aisr/bin/logname 
AisrA»n/mail 
Aisr/bin/pack 
/ua/binAinpack 
linked to ./usr/bin/pcat 
/usr/bin/rmail 
Aisr/bin/what 
/usr/cdemo/. cshrc 
Aisr/ vdono/ . profile 
/usr/lih/calpiog 
/usr/Uh/crontab 
/uar/iilVdifQi 
/usr/Iib/ex2. 1 3rccovcr 
/usr/Uh/lib.bc 
Aisr/Iib/mail/aliases.hash 
/usr/lib/mail/daemon. mn 
/usr/lih/mail/execmail 
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floppy ^"^ 



/usr/lih/maU/nuuI. local 
/usr/UtVmail/mailhe^.cmd 
/usr/lih/mail/mailbelp. set 
/usr/lih/mail/maliaaet 
/uar/lih/mkuser. help 
/usr/tiiymkuser. prof 
/usr/lih/tabaet/ambu 
/usr/litVtabset/diablo 
/usr/lilVtabset/stdcn 
/usr/lifa/tabset/vtIOO 
/usr/lifa/uiiituib 
/usr/bin/setcolor 
/uar/bin/doscat 
/usr/bin/dosb 
lirtkedto .Aisr/btn/dosdir 
/u»/bin/VSHELL.HPT 
/usr/bin/menu.def 
/usr/spool/at/lasttimedone 
/usr/spool/inail/demo 
/usr/spool/mail/vdano 
/etc/defauh/msdos 
/etc/masterboot 



/usr/Ub^mail/mail. mn 
/usr/lih/mail/mailbelp. eac 
/usr/lih/mail/maibc 
^sr/Ub/makekey 
/usr/lih/mlnuer.mail 
/usr/Uh/more.help 
/usr/lih/tabset/beehive 
/uar/lib/tabaet/std 
^sr/Iih/labset/tele^ly 
/usr/Iih/tabset/xeroxl 720 
/usr/btn/remote 

Unkedto ./uai/Uh/mail/ouil.mn 
Aisr/bio/dosdir 
/usr/bia/fomuC 
Aisr/bin/VSHELL.HPP 
/uar/bin/vsh 
/usr/puh/ascii 
Aisr/^)ool/at/past/xyz 
Aisr/spool/mail/cdemo 
/usr/spool/mail/root 
/etc/badblkutil 
/once/init.baae 



floppy #8 



/etc/uuq>.penxu 
/uar/bin/uulog 
/usr/bin/uuscnd 
/usr/lih/uuqVL - devices 
/usr/lih/uucp/L . sys 
/usr/blVuucpi/USERflLE 
/usr/tib/uucp/uuclean 
/oace/init.uuqy 



/usr/bin/uurp 

/usr/bin/uux 

/usr/bln/uunow 

/usr/lih/uuqyL— diakodes 

/usr/ltb/uucp/L. cmds 

/usr/libAiucp/uucico 

/usr/lih/uuqj/uuxqi 



floEESLfi. 



/bifl/pstat 
/etc/baae.penns 
/etc/texmcap 
/etc/lpopea 
/etc/ny^nP^ 
/usr/bin/doscat 
/uff/bin/dosb 
linked toAisr/bin/doadir 
/uff/bin/dosnndir 
linked to/uff/bin/doflna 
/oQce/l.l.pennt 
/oncc/ttytype 



/bia/csh 

/etc/soft, peima 

/cte/rc 

/etc/profile 

/etc/de&uk/mados 

/usr/bin/do6dir 

/uar/bin/dosmkdir 

/usr/bin/dosrm 

/usar/bin/vdi 

/usr/bin/VSHHX.HPT 

/ooceAestcokr 

/etc/defauh/mkuser 
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/etc/mkuser /usr/lib/mkuser/mkuser.help 

/usr/Iitymkuser/mkuacr.mail /usr/Ub/mkuser/mkuser.praf 

/usr/lih/mkuser/mkuaer. login Aisr/lib/mkuser/mkuser.csfarc 

/etc/nnuaer /etcAz 

/usr/adm/msgbuf /ooce/init.1.1 
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